Skip to main content

Affichage des textes

Vous pouvez afficher des textes dans un élément en spécifiant le texte dans le Textes → Texte propriété.

Vous pouvez également afficher un texte sous forme d'info-bulle (Textes → Info-bulle propriété de l'élément).

Ces textes sont statiques. Ils sont gérés automatiquement dans le Liste de textes globale objet dans le POU La vue ne peut être modifiée ni par programmation ni par saisie utilisateur pendant l'exécution de la visualisation. Cependant, vous pouvez étendre un texte statique d'un seul espace réservé avec une spécification de formatage afin d'afficher le contenu d'une variable à ce stade. La valeur réelle de la variable que vous avez affectée dans le Variable de texte la propriété sera alors affichée au moment de l'exécution.

Astuce

Pour plus d'informations sur les spécifications de formatage, voir : Espaces réservés avec définition de format

Lorsque l'encodage UTF-8 est activé pour le STRING Les textes contenant des caractères spécifiques à une langue sont autorisés. Ces caractères, tels que les signes diacritiques ou les caractères chinois, peuvent être spécifiés en entrée comme en sortie. Vous pouvez activer l'encodage UTF-8 dans Boîte de dialogue : Paramètres du projet : Options de compilation.

Vous pouvez animer l'affichage strict du texte visuel au moyen d'une configuration dynamique.

Vous pouvez localiser les textes statiques si vous avez configuré la capacité multilingue dans le projet.

Afficher dynamiquement une valeur de variable

L'élément sort le résultat d'un code ST exécuté sur un clic de souris sous forme de texte.

Condition : un projet avec une visualisation est ouvert.

  1. Ouvrez la visualisation et ajoutez un Bouton élément.

    le Propriétés la vue s'ouvre pour le nouveau bouton.

  2. Configurez le Texte biens: Number of clicks: %i.

    La chaîne contient l'espace réservé %i.

  3. Dans l'application, dans le PLC_PRG POU, déclarez une variable conforme au type : iClicks : INT;.

  4. Configurez le Variable de texte propriété du bouton comme PLC_PRG.iClicks.

    La valeur de la variable est sortie à la place de l'espace réservé au moment de l'exécution.

  5. Dans le Configuration d'entrée propriété, cliquez sur le Configurer bouton dans le OnMouseClick ligne.

  6. Sélectionner Execute ST code dans la liste des actions possibles.

  7. Programmez le code de l'action sous l'éditeur dans Exécuter le code ST:

    PLC_PRG.iClicks := PLC_PRG.iClicks + 1;

  8. Cliquez sur d'accord pour quitter la boîte de dialogue.

    L'entrée utilisateur est configurée.

  9. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre. L'élément est étiqueté et le nombre de clics est affiché. Le nombre est augmenté si vous, en tant qu'utilisateur, cliquez sur le bouton.

    _visu_img_user_input_button.png

Sortir dynamiquement du texte à partir d'une liste de textes

Vous pouvez générer dynamiquement du texte à l'aide de la Champ de texte élément. Vous pouvez implémenter une sortie de texte par une entrée utilisateur ou par programmation.

Condition : un projet avec une visualisation est ouvert.

  1. Ouvrez la visualisation et ajoutez un Champ de texte élément.

    le Propriétés La vue montre la configuration de l'élément.

  2. Sous l'application, ajoutez une liste de textes avec des entrées de liste de textes : Textlist_A.

    _visu_img_textlist_a.png

  3. Dans l'application dans le POU PLC_PRG, déclarez la variable texte : strTextID : STRING := '0';

  4. Déclarez-y également la variable strTooltipID : STRING := '0';

  5. Déclarez-y également la variable iText : INT;

  6. Configurez le Textes dynamiques → Liste de textes propriété avec 'Textlist_A'.

  7. Configurez le Textes dynamiques → Index des textes propriété avec PLC_PRG.strTextID.

  8. Configurez le Textes dynamiques → Index des info-bulles propriété avec PLC_PRG.strTooltipID.

  9. Dans l'application dans le POU PLC_PRG, programmez l'instruction CASE comme indiqué ci-dessous.

    Les variables dans le Textes dynamiques biens sont programmés.

  10. Configurer la propriété Configuration d'entrée → OnMouseclick pour Execute ST code avec PLC_PRG.iText := (PLC_PRG.iText + 1) MOD 4;

    Une entrée utilisateur est configurée pour le Champ de texte élément.

  11. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre. Le texte None est affiché dans le champ de texte. Si vous, en tant qu'utilisateur, cliquez sur l'élément, le texte devient Dynamic_ File_A. De plus, l'info-bulle correspondante s'affiche : Information A. Le texte change à chaque clic selon l'instruction CASE.

    _visu_img_output_dynamic_text.png

Instruction CASE

CASE iText OF
    0:  strTextID := '0';
        strToolTipID := '0';

    1:  strTextID := '1';
        strToolTipID := '4';

    2:  strTextID := '2';
        strToolTipID := '5';

    3:  strTextID := '3';
        strToolTipID := '6';
ELSE
    strTextID := '0';
    strToolTipID := '0';
END_CASE;

Configurer la saisie d'un champ de texte

Pour que l'utilisateur puisse saisir du texte dans un champ de texte, configurez une entrée du type Écrire une variable à une variable de sortie texte. Cette variable de sortie de texte enregistrera l'entrée de l'utilisateur et affichera le texte de sortie à la place de l'espace réservé ( %s dans l'exemple ci-dessous). Vous spécifiez la variable de sortie de texte dans le Variables de texte → Variable de texte biens.

Condition : un projet avec une visualisation est ouvert.

  1. Dans l'application dans le POU PLC_PRG, déclarez une variable chaîne : strInput : STRING;

  2. Ouvrez la visualisation et ajoutez un Champ de texte élément.

    le Propriétés La vue montre la configuration de l'élément.

  3. Configurez le Textes → Texte propriété avec Input: %s.

  4. Dans le Configuration d'entrée propriété pour le OnMouseClick action de la souris, clic Configurer pour ouvrir le Configuration d'entrée dialogue. Sélectionnez le Écrire une variable action dans la boîte de dialogue et activez le Utiliser la variable de sortie de texte option à cet effet. Cliquez sur d'accord pour fermer la boîte de dialogue.

  5. Attribuez maintenant la sortie de texte PLC_PRG.strInput variables dans le Variables de texte → Variable de texte biens.

  6. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre. L'élément affiche le texte : Input:. Cliquez sur l'élément. Un champ de saisie apparaît alors dans lequel vous pouvez saisir une chaîne. Le texte est accepté lorsque vous appuyez sur la touche Entrer clé.

    _visu_img_current_imput.png

Configurer la sortie dans un champ de texte

Vous pouvez utiliser le Champ de texte élément dans votre visualisation afin d'y afficher du texte ou de donner à l'utilisateur la possibilité d'entrer dans cette variable.

De plus, vous pouvez configurer une saisie de texte. Lors d'une saisie de l'utilisateur, un champ de saisie apparaît alors dans la zone de la fenêtre du Champ de texte élément. Cela nécessite la configuration d'une entrée utilisateur dans le Configuration d'entrée biens.

Affichage du texte sous forme d'info-bulle

Condition : un projet avec une visualisation est ouvert.

  1. Ouvrez la visualisation et ajoutez un Champ de texte élément.

    le Propriétés La vue montre la configuration de l'élément.

  2. Configurez le Textes → Texte propriété avec File name: %s.

    Le texte contient l'espace réservé %s.

  3. Configurez le Textes → Info-bulle propriété avec Storage location: %s

  4. Dans l'application dans le POU PLC_PRG, déclarer une variable conforme au type strFileName : STRING := 'File_A';

  5. Dans l'application dans le POU PLC_PRG, déclarer la variable strFileDir : STRING := 'D:/Data';

  6. Configurez le Variable de texte propriété du champ de texte avec PLC_PRG.strFileName.

    Le contenu de la variable sera affiché à la place de l'espace réservé au moment de l'exécution.

  7. Configurez le Info-bulle propriété du champ de texte avec PLC_PRG.strFileDir.

  8. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre. L'élément affiche le texte : File name: File_A Lorsque le pointeur de la souris se déplace sur le champ de texte, l'info-bulle apparaît : Location : D/Data.

    _visu_img_output_text.png

Animation de l'affichage du texte

Vous pouvez paramétrer une animation de l'affichage du texte dans le Variables de police biens. Tous les éléments de base ont cette propriété ainsi que les tableaux, les barres de défilement et les champs de texte.

Procédure. Exemple : Animer la taille de la police

Condition : un projet avec une visualisation est ouvert.

  1. Ouvrez la visualisation et ajoutez un Rectangle élément.

    le Propriétés La vue montre la configuration de l'élément.

  2. Configurez le Textes → Texte propriété avec Important.

  3. Dans l'application, déclarez une variable conforme au type dans le PLC_PRG PU.

    iFontHeight : INT;

  4. Configurez le Variables de police → Taille propriété avec PLC_PRG.iFontHeight.

  5. Implémentez un changement dans la taille de la police.

    iFontHeight := iFontHeight + 1) MOD 20;

  6. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre. Le rectangle est étiqueté Important. La taille de la police passe de 1 à 20.

Étiquetage

Vous pouvez sortir des informations à l'aide de la Étiqueter élément.

Condition : un projet avec une visualisation est ouvert.

  1. Ouvrez la visualisation et ajoutez un Étiqueter élément.

    le Propriétés La vue s'ouvre avec ses propriétés par défaut.

  2. Configurez le Textes → Texte propriété avec Visualization A.

Pour plus d'informations, consultez : Étiqueter

Masquer un élément

Vous pouvez configurer le Variable d'état → Invisible propriété pour masquer un élément.

Exigence : vous disposez d'un champ de texte dans la visualisation qui s'affiche uniquement si une variable d'application spécifique est TRUE. Par exemple, pour afficher des instructions ou une explication pour un état spécifique uniquement.

  1. Configurez le Textes → Texte propriété pour le champ de texte avec Error detected: Do the following....

    Configurez le Propriété Texte → Couleur de la police propriété avec Rouge foncé.

  2. Dans PLC_PRG, déclarer la variable bIsInvisible : BOOL := TRUE;

    L'initialisation ici est pour l'exemple; sinon, la variable est définie sur TRUE par le programme d'application sous certaines conditions.

  3. Configurez les Variables d'état → invisibilité propriété avec PLC_PRG.bIsInvisible.

  4. Compilez, téléchargez et démarrez l'application.

    L'application s'exécute. La visualisation s'ouvre et le champ de texte est invisible. Si vous définissez maintenant 'bIsInvisible' sur TRUE, le champ de texte apparaît.

Alignement du texte avec espacement sur le cadre de l'élément

Éléments avec le Alignement horizontal ou Alignement vertical La propriété de l'élément peut non seulement aligner son texte verticalement ou horizontalement, mais également utiliser son style pour aligner le texte afin que le texte soit affiché avec un espacement (en pixels) à partir du bord de l'élément.

De plus, définissez les propriétés de style suivantes dans votre style :

Figure 1. Propriété de style pour l'alignement du texte avec espacement
Propriété de style pour l'alignement du texte avec espacement


Le affecte les éléments suivants :

La valeur d'espacement est appliquée uniquement lorsque l'alignement n'est pas centré.

Exemple 6. Exemple : Style de visualisation Test for text field margin
_visu_example_style_margin.png


Dans cette section​: